Skip to main content

task claim_role

Command Title​

/task claim_role

Description​

This command allows you to set up a task that rewards a specific role with points for claiming the reward within a specified time interval. This can be used to encourage role engagement and provide exclusive benefits to members of a particular group.

Usage​

/task claim_role <reward> <period> <role>

Parameters​

  • <reward>: The value must be a positive integer. This represents the number of points awarded to users of the specified role when they claim the reward.
  • <period>: This parameter determines how often the role can claim the reward. Available options are Daily, Weekly, and Monthly.
  • <role>: This parameter specifies the role that can claim the reward. Only users with this role will be able to activate the task and receive the points.

Examples​

  • Example 1: Set up a daily task that rewards the @VIP role with 10 points for claiming the reward:

    /task claim_role reward:10 period:Daily role:@VIP

  • Example 2: Set up a weekly task that rewards the @SVIP role with 20 points for claiming the reward:

    /task claim_role reward:20 period:Weekly role:@SVIP

  • Example 3: Set up a monthly task that rewards the @PREMIUM role with 50 points for claiming the reward:

    /task claim_role reward:50 period:Monthly role:@PREMIUM

Notes​

  • Users can only claim the reward once per period.
  • The reward amount must be a positive integer.
  • The period can be set to Daily, Weekly, or Monthly.
  • Only users with the specified role will be able to claim the reward.

FAQs​

  • Q: Can I set up multiple claim role tasks with different reward values and periods?

    A: Yes, you can create multiple claim role tasks with varying reward values and periods. Each task will be tracked independently.

  • Q: What happens if a user claims the reward before the specified period has elapsed?

    A: Users can only claim the reward once per period. If they attempt to claim it again before the period has ended, they will receive a message indicating that they must wait until the next period.

  • Q: What happens if a user's role changes after they have claimed the reward?

    A: If a user's role changes after they have claimed the reward, they will still be able to receive the points. However, they will not be able to claim the reward again until the next period has elapsed.